home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 049a / boxb314.zip / BOXBEL.DOC < prev    next >
Text File  |  1991-10-06  |  7KB  |  182 lines
  1.  
  2.  
  3.  PLEASE! IF BOXBEL ISN'T RUNNING VERY WELL ON YOUR SYSTEM, THEN
  4.  PLEASE DROP ME A NOTE! INCLUDE YOUR LOGFILE WHICH CAUSED THE
  5.  BUG. I'M TRYING EVERYTHING POSSIBLE TO MAKE BOXBEL RUN SMOOTHLY.
  6.                                                Tommy Roeder 2:244/8001
  7.  
  8.  
  9.  
  10.      +++++++ BOXBEL/tr Version 3.14 +++++++
  11.  
  12.    An automatic callers-to-my-bbs-creator for
  13.  
  14.                    QuickBBS
  15.                  running with
  16.             D'Bridge or FrontDoor
  17.  
  18. (in fact it works nice even without QuickBBS :-)
  19.  
  20.  
  21.  REMEMBER TO READ BOXBEL.NEW!!!
  22.  
  23.        We had a statistic-overview of the human callers
  24.     to our BBSs available to our users (the
  25.     corresponding program looked at the system-logfile).
  26.     Now there have been some users wondering why the
  27.     system is busy so often even if there haven't been any
  28.     users since hours in the BBS according to the
  29.     mentioned statistic-file. The answer is easy: Some
  30.     other fido-system did a filerequest or was exchanging
  31.     mail with our fido-mailer. We saw that there is need
  32.     for a program that not only processes the system- but
  33.     also reads the mailer-logfile and extracts the made
  34.     connections. BOXBEL was born (the word "boxbel" is put
  35.     together by the two german words "(Mail)Box" and
  36.     "Belegung" which means something like "system usage").
  37.  
  38.        This very fast and easy to use program so reads
  39.     DBRIDGE.LOG or FD.LOG (or whatever you named your
  40.     FrontDoor-logfile) and SYSTEM.LOG and filters
  41.     out all made connections with your BBS. The result is
  42.     sorted by date and time and put into two textfiles
  43.     BOXBEL.ASC (monochrom version) and BOXBEL.ANS
  44.     (colo(u)r version). The BOXBEL-configuration-file
  45.     allows you to change the name of these two files.
  46.  
  47.      For QuickBBS-Sysops: Set the path where to write
  48.     these textfiles to in the boxbel-configuration-file
  49.     pointing to your QuickBBS-textdirectory and create a
  50.     menu-type 5 command to let your users read these files.
  51.     Users which didn't get access to your system
  52.     (typed wrong password three times and so on) are
  53.     skipped automatically.
  54.  
  55.  
  56.    These files are included in this package:
  57.    -----------------------------------------
  58.  
  59.    BOXBEL.NEW    -----> READ THIS!!!
  60.    BOXBEL.EXE    -----> BOXBEL main-program
  61.    BOXBEL.CFG    -----> configuration-file for BOXBEL
  62.    BOXBEL.DOC    -----> the english document (you are
  63.                            reading it right now)
  64.    BOXBEL.REV    -----> BOXBEL revision-history
  65.    
  66.  
  67.    BOXBEL can be put to downloading areas of BBSes if:
  68.    - the original archive isn't changed in any way
  69.      except compression method
  70.    - the archive contains all files of the original
  71.      distribution archive
  72.  
  73. !     We don't want any money for the program but we want to
  74. !    know who is using BOXBEL and how he (or she) is satisfied
  75. !    with it. In fact BOXBEL was hard work over months.
  76.  
  77.  
  78.    Installation of BOXBEL:
  79.    -----------------------
  80.  
  81.    1. What you need:
  82.       - QuickBBS
  83.       - D'Bridge or FrontDoor
  84.                               (NOTE: BOXBEL/tr is only tested with
  85.                                      FrontDoor! If you want a tested
  86.                                      D'Bridge-Version then write to
  87.                                      Werner Niedermeier, 2:246/2!)
  88.  
  89.    BOXBEL knows whether you are using D'Bridge or
  90.    FrontDoor: If the last seven characters of your
  91.    mailer-logfile-name (in BOXBEL.CFG) are "dbridge.log"
  92.    then it is assumed that you prefer D'Bridge,
  93.    everything else is regarded as a FrontDoor-Logfile.
  94.  
  95.    2. The configuration-file BOXBEL.CFG:
  96.       Take a text-editor and modify BOXBEL.CFG to
  97.    your needs. We tried everything possible to make
  98.    the config-file self-explaining. Please be sure not
  99.    to change the order of the lines and not to insert
  100.    any empty lines. Remarks are preceeded by a
  101.    semicolon on the first position of the line. Don't
  102.    forget the trailing backslash when changing the
  103.    pathname to your textdirectory. It is
  104.    wise to put a ";" before the example-configuration
  105.    shipped with BOXBEL. So if you don't remember quite
  106.    well later you have the original statements to help
  107.    you setting up the file.
  108.       If you don't want to exclude a name from the
  109.    lists (see BOXBEL.CFG) then mark this line with
  110.    "---".
  111.  
  112.    Next thing to do is to insert BOXBEL in your
  113. batchfile which runs your mailbox. You can call
  114. BOXBEL every time a user leaves your system
  115. (recommended) or once a day or whenever you like.
  116.  
  117.  
  118.    Running BOXBEL (command-line parameters):
  119.    -----------------------------------------
  120.  
  121.    BOXBEL needs at least two command-line parameters. 
  122.    Three more are optional. The correct syntax is:
  123.  
  124.    BOXBEL /{D|E} /Unnn [/Q] [/R] [/NOCTL]
  125.  
  126.    /D --> BOXBEL creates german ("deutsch") messages
  127.           and statistic-files
  128.    /E --> BOXBEL runs in "english-mode" (nice, eh?)
  129.  
  130.    /Unnn  The number "nnn" tells BOXBEL the maximum of
  131.           entries to include in the final statistic-
  132.           files. So if you want the last twenty calls
  133.           to your system included in BOXBEL.A?? then
  134.           you have to run BOXBEL like this:
  135.              boxbel /e /u20
  136.           If there are less entries found in the
  137.           mailer- and QuickBBS-logfile then BOXBEL
  138.           also puts less entries into the statistic-
  139.           file. When BOXBEL is running it shows you
  140.           the number of entries found in the
  141.           two logfiles. The last "/Unnn" entries are
  142.           then filtered out and sorted. This version
  143.           of BOXBEL is limited to a total number
  144.           of 5000 entries to proceed (which actually
  145.           means that your logfiles are some Megabytes
  146.           long...). If you find this to be not
  147.           enough then you better should think of doing
  148.           a regular clean-up of your system.
  149.  
  150. The next options are really optional:
  151.  
  152.    /Q --> Quiet-mode. The line-counters aren't displayed.
  153.           This maybe somewhat faster on some systems but
  154.           you will miss the nice counters...
  155.    /R --> Reverse-Date-Mode. Default is to sort the entries
  156.           from the eldest to the newest entry. If you specify
  157.           /R then BOXBEL puts the newest entries on the top
  158.           which is recommended by us.
  159.    /NOCTL --> Normally BOXBEL puts special ctrl-chars at the
  160.           end of its reports. If displayed by QuickBBS the
  161.           user is then prompted to press any key. If you don't
  162.           want this, because you are running any other BBS or
  163.           you want to include the reports into a message then
  164.           use this parameter. BOXBEL will then design BOXBEL.ASC
  165.           as plain ASCII.
  166.    /GR --> Display nive graphix-bar when running.
  167.    /SN --> Display Sysopnames rather than Systemnames.
  168.  
  169.  
  170.  
  171.  
  172.    We hope that you find BOXBEL to be as useful as we do!
  173.  
  174.  
  175. Tommy Roeder,
  176.    Sysop of 2:244/8001 Radio Baldham (West-Germany)
  177.             (BBS: +49-8106-31180) 1200-2400 Baud + HST + V.32bis + V.42bis
  178.  
  179. Werner Niedermeier,
  180.    Sysop of 2:246/2 C.A.C.-BOX Munich (West-Germany)
  181.             (BBS: +49-89-7212827) 1200-2400 Baud + PEP
  182.